home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / util / misc / DragBox.lha / GetBox.txt < prev   
Text File  |  1999-02-07  |  3KB  |  130 lines
  1.  
  2. -GetBox- v1.0 (23.10.98)
  3.  
  4. Introduction
  5. ************
  6.  
  7. Returns coordinates of the current active window on the screen.
  8. Read more info and instructions from DragBox archive.
  9.  
  10.  
  11. Distribution
  12. ************
  13.  
  14.    Copyright (C) 1998-1999 Juha 'Asa' Pinola
  15.  
  16.    GetBox is available as freeware.  That is, it may be freely distributed
  17. in  unmodified  form  with  no changes what so ever, but you may not charge
  18. more than  a nominal fee covering distribution costs.  However, donations
  19. are welcome.
  20.  
  21.    If  you use this software in a commercial or shareware software product,
  22. please   consider  giving  the  author  and  preferably  each  one  of  the
  23. contributors an original or registered version of your work.
  24.  
  25.    If you wish to distribute this software with a hardware product, contact
  26. the author.  Distribution of GetBox with hardware products is not free.
  27.  
  28.    THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS "AS IS" AND ANY
  29. EXPRESS  OR  IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  30. WARRANTIES  OF  MERCHANTABILITY  AND  FITNESS  FOR A PARTICULAR PURPOSE ARE
  31. DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY
  32. DIRECT,  INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  33. (INCLUDING,  BUT  NOT  LIMITED  TO,  PROCUREMENT  OF  SUBSTITUTE  GOODS  OR
  34. SERVICES;  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  35. CAUSED  AND  ON  ANY  THEORY  OF  LIABILITY,  WHETHER  IN  CONTRACT, STRICT
  36. LIABILITY,  OR  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  37. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  38. DAMAGE.
  39.  
  40. ****************************************
  41.  
  42.  
  43. Installing
  44. ----------
  45.  
  46. Just copy GetBox to c:GetBox or somewhere else.
  47.  
  48. For faster response insert a line:
  49. "resident c:getbox pure >nil:"    to your s:startup-sequence
  50. or s:user-startup
  51.  
  52.  
  53.  
  54. ****************************************
  55.  
  56.  
  57. The Author
  58. ----------
  59.  
  60.    The author can be reached at the following addresses:
  61.  
  62. Electronic mail
  63.      jpinola@cs.joensuu.fi
  64.  
  65. World-Wide Web
  66.      http://cs.joensuu.fi/~jpinola
  67.  
  68. IRC: Asa/#amigafin/#amycoders
  69.  
  70.  
  71. ****************************************
  72.  
  73.  
  74. Example usage:
  75.  
  76.  
  77. You can change the return format:
  78. `c:detbox.exe format "left %ld top %ld "`   (Only x,y coords)
  79. `c:getbox.exe format "x=%ld y=%ld w=%ld h=%ld"`   (All coords)
  80.  
  81. Or change the environment variable:
  82. `c:getbox.exe env GETBOX_DEFAULTS2`
  83.  
  84.  
  85. ****************************************
  86.  
  87.  
  88. Command line parameters:
  89.  
  90. "X=DEF_X/N,Y=DEF_Y/N,W=DEF_W/N,H=DEF_H/N
  91.  FO=FORMAT/K,ENV/K"
  92.  
  93. X           = Default x
  94. Y           = Default y
  95. W           = Default width
  96. H           = Default height
  97. FORMAT      = Format of return string. %ld for number (x,y,w,h)
  98. ENV         = Set name of the environment variable. (use only names no paths! default: GETBOX_DEFAULT)
  99.  
  100. ****************************************
  101.  
  102.  
  103. Env variable:
  104.  
  105. GETBOX_DEFAULTS = [as command line]
  106.  
  107. Example: ( "setenv GETBOX_DEFAULTS DEF_W 600" )
  108.  
  109. (copy env:GETBOX_DEFAULTS to envarc:)
  110.  
  111.  
  112. ****************************************
  113.  
  114. Notes and bugs:
  115.  
  116. (factory defaults:
  117. "X 0 Y 0 W 200 H 200 FORMAT "%ld/%ld/%ld/%ld" ENV GETBOX_DEFAULT"
  118. )
  119.  
  120.  
  121. ****************************************
  122.  
  123. History:
  124.  
  125. --------------
  126. v 1.0
  127.  
  128. + Released with DragBox
  129.  
  130.